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Free [devname] Usage : Displays number of free sectors on a device @GFX 
Syntax: RUN GFX(<funct><args>) Usage : Graphics interface package for 
BASIC09 to do compatible VDG graphics commands (S>GFX2 Syntax: RUN 
GFX2([path]<funci><args>) Usage : Graphics interface package for BASIC09 to 
handle 
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:pathname> Usage 

directory tile @MDIR. Syntax: Mdir [e] Usage : Displays the present memory 

module directory Opts : e = print extended module directory @VIERGE Syntax: 
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execution directory path @RENAME Syntax: Rename <riiename> <new filename 
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ra)TMODE ^^ 

the operating parameters of the terminal @TUNEPORT Tuneport </tl or /p> 
[value] Adjust the baud value for the serial port (©UNLINK Syntax: Unlink 
<modname> Usage : Unlinks module(s) from memory @WCREATE Syntax: 
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0S9 ECHO 

Ve are pleased to advise of a good deal of progress on 

the FIDO 0S9 EHCO since our article last iionth. Access 

to the 0S9 Comiunity Network is now available in 

Australia and He» Zealand through the FIDO worldwide 

network. 

How that the 0S9 ECHO is being brought into Australia, 
Fido Zone 3, which, as I understand it, includes Hew 
Zealand, we have the potential for a very low cost aeans 
of staying in touch with the 0S9 scene worldwide. There 
is a cost for this service which at the aoment is being 
borne largely by OHE Fido Sysop in Brisbane on a trial 
basis. 

I do not claii to be an expert on the Fido Bail system 
but will try to explain the basics of the systeii as they 
will affect us. Eiiail Messages are posted to a local 
Fido BBS at the cost of a local telephone call which will 
be directed to the 'Echo' or to a specific Fido address. 
All nessages are sent in a 'packet' to a HUB. These 
'packets' are in sinple terns transfered froii one BBS to 
another in the Network and messages posted to EVERY BBS 
in the network (can be worldwide) or private messages end 
up at a single specified BBS which can be anywhere in the 
worldwide network. 

The cost of bringing in the 0S9-ECH0 into zone 3 is 
estimated at 540.00 per month. So if only ONE user was 
to access this Echo, it would be reasonable to expect a 
charge of $40.00 per month. TVO users could share this 
cost at 520.00 per month, and so on. This reaches a 
point where a BBS Sysop would charge a very small fee or 
may provide this FREE. As in, no charges other than 
their normal membership fee. Typically, BBS membership 
would be appoximately 535 to 540 per year. 

How here is the crunch, we need as many Hatgroup members 
as possible to share the cost of access to this 0S9-ECH0 
used by the 0S9 Community Network as a cost effective way 
of information transfer. 

Fido BBS systems are available everywhere and there 
should be at least one in the local telephone district of 
each Hatgroup member. 

Log on to one of these and follow the membership 
application requirements of that BBS. Hext, arrange with 
the Sysop for him to get the 0S9-ECH0. The Sysop would 
be able to get details from Galaxy Gateway - Fido address 



3:640/316 (James Collins is the Sysop of this BBS) 

telephone (BBS) 07-207-8900. This would immediately 
reduce the cost to the Galaxy Gateway as some of the cost 

is then borne by the Sysop in your area. This Fido 

network also offers a low cost means for US, the members 

of the National Usergroup, to stay in touch and share 
information. 

I should point out that the Fido Hetwork has some very 
definite rules which each user, and Sysop, is obliged to 
follow. Each BBS will list these rules; please take the 
trouble to read and understand them. Aa an ■0S9 
Community' we do want to be seen as 'responsible" users, 
e.g. Private messages (question or answer to one 
individual) should be sent through FIDOHET mail system as 
this avoids every Sysop on the network carrying, and 
paying for, the private message. Echo means that the 
message is "echoed' to everybody on every BBS in the 
system that takes the 0S9-ECH0. 

MODEMS 

If you do not have a Modem at present and are put off by 
the cost of a 2400 baud Modem, then maybe we can help. I 
used a 300 baud Modem for a number of years, and in fact, 
my used and perfectly good modem just sits on a shelf. 
If you would like an Avtek Mini-Modem II (300 and 
1200/75), make an offer and I will send it. Rob Mackay 
also has one of these, plus an Avtek Kultimodem [300, 
1200/75 + 1200 Half Duplex) which he has offered for the 
price of a carton of beer plus postage. A Stop-press!! 
Don Berrie also has available a ACESAT 300, 1200/75 baud 
modem at about the same price. 

Communication at 300 Baud is a little slow but it still 
costs no more than the price of a local telephone call. 
An RS-232 Pak could however be another problem. I see 
reports on the Echo of people running a Modem through the 
CoCo serial (bit-banger) port, so we plan to run some 
tests to see how reliable this is before suggesting this 
approach. 

Ve also have a number of P.D, terminal programmes 
available; uploaded to Galaxy Gateway in Brisbane, you 
can get them from there, or send a disk and they are 
yours. 

Veil there we have it, we have arranged this worldwide 
access to information on our favourite operating system, 
so it is now over to each of you to support this 
important venture. If we all get behind it, the cost to 
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each of us fill be very little. Ve have had a number of 
requests over the past four years for the Hatgroup to run 
a BBS, nof le can achieve soiiething better and avoid STD 



charges. 



Cheers, Gordon, 



ooooooooooOOOOOOOOOOoooooooooo 



THE QS9 L2 UPGRADE SrORY 
By: Sevin Darling. 



BACJGROUHD Apr-Sep 88 - prehistory, private work 
That April, Kent Meyers and nyaelf got find that an 
update was coning and fe began passing along any bugs le 
found to the CoCo guys at Tandy. Partly because KV fas 
getting out of the 6809 by then, I got the job. 

At the end of September, MV flew ne up to Des Moines to 
get info needed for two projects at the saie tine: the 
L-n update, and a port of sonething to the Atari ST. 
Both were supposed to be done by the end of that year; 
the plan was to first do all the known L-II bugfixes, and 
also add any enhancements possible within a few weeks. 
And that was all, at first. 

In October, the ST project got cancelled. Otherwise, the 
L-II update would've been out way back then, and yet 
you'd have spent $20-30 for nothing [in comparison to 
what you've gotten free off the nets since). 

Actually we'd be worse off than that, as most serious 
work would've stopped and there'd have been _no_ fast 
grfdrv, new gfx2, clock patches, acia speedups or a dozen 
other neat giveaways which came along... much, much later 
on. 

HEV OEIGIUAL SCHEDULE Oct-Dec 88 - new timeframe for 
official upgrade 

How we suddenly had some more time for L-II work (tho not 
much more), and both Mtf and Tandy gave carte blanche to 
add whatever we wanted. (Applause!) Knowing that this 
update would also become the new stock L-II release, I 
wanted a lot in there (grin), but needed some help doing 
so, 

)From that arose together for the common good, modifying 
their own drivers to come into upgrade coipliance. 



this time we were also friting demo programs that fent 
beyond what anyone else had tried, and discovered (as 
others have recently) that tfindint had major problems 
with multiple overlays and menus. 

I _should've_ collected the money and run right then, but 
<sigh> I wouldn't have been able to face myself later if 
I had done so. Dumb? Maybe. Hmm. But remember, this 
was going to be the new stock L-II.., 



G0I8G BEYOHD Feb-Mar 89 ■ rewrite 
major and minor fixes Apr-May 89 ■ 
speedups applied, CLEAS problem solved 



windint, numerous 
grfdrv crunch and 



So we all continued, and I rewrote much of Vindint. In 
the meantime, Kent was carving out huge chunks of room 
for me in Grfdrv, and that let me create those Grfdrv 
speedups you have now. Ve also were able to find a lot 
of new and really obscure/rare bugs, and fix them. Best 
of all, I also worked out a simple and effective fix for 
the irq stoppage when changing HV screens (and you 
already have that too! included in Bruce Isted's IBM 
mouse patch). 

Thus the end of May 1989 was the next best stopping 
point, and in fact that's pretty much the version I 
myself still run today. The volunteer work was still 
ongoing tho... and something else happened: remember the 
SainbowFest when CerComp's 'Vindow Master - you don't 
ha'ie to be an OS-9 rocket scientist to have overlapping 
windows" RSDOS program came out? Kinda miffed me :-) 
"HA!", I gritted my teeth, 'you wanna see easy-to-use 
overlapping windows?!' 



GOISG TOO FAR Jun-Aug 8' 
resizeable windows, new gfx2 



overlapping, moveable, 



To say that all this was unique in 
would be an obvious understatement! 



the history of OS's, 



How, altho no one at Tandy/M¥ ever said 'Let's stop here' 
(and I did so a few weeks too late), there _were_ times 
that a version could've been released: 



Sure :) From June to the end of August, 'super-windows' 
was written. After enormous work... 3-D look, moveable, 
resizeable, non-stopping, overlapping windows were 
crammed into the original 8K Grfdrv space. Still proud 
of that! You could even pick up windows and move them to 
other screens. Too neat. 



ESD OF FIRST tfORK Jan 89 - original clean up work 

done 

Okay, we could've stopped in January 1989. But that 

still would've left tons of possible stuff untouched. By 



Too neat. And useless. Great for demos and fun to play 
with (Dale Puckett loved 'em), but they took up slightly 
too much RAM, slowed down the covered windows, and 
compared to the fall-screen apps we were used to: just 
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useless. Overlappiag viadots make a 
sease oa a larger display, yah? 
inpossible on a 128K systei, which 
specs . So I thiak they'll remain a 



hecku7a lot more 

Also, they were 

was part of the 

curiousity piece 



forever. Or probably go in OSK. Anyway, I decided to 
yank those and put back in other, more needed, stuff. 

9ut y'all got much of the aew GFX2 from that part of the 
project, too! 



9 - coco cancelled 

(which would've caused us to 
the CoCo got cancelled... just as 

99% done (I'm sure even the 



SUDDEH DEATH Sep ! 
Without _any_ warning 
immediately wrap up), 
everyone involved was 
remaining Tandy CoCo guys were caught totally off guard]. 



TEE PEOPLE, AHD tfHAT VE PROVED 

Evea tho the upgrade got abruptly cancelled, I believe we 
easily proved that there's a __lot_ of talent out here 
that HV can and should make use of... not only by farming 
out paying projects, but even down to using volunteers to 
check over aay of their current code (it's amazing what a 
third person can find aad fix, or at least optimize). 

[ Incredibly, many of the volunteers are aormally well 
paid professioaals (at least two coders were people HV 
had failed to entice to Des Moines :-) I'd guesstimate at 
least .25 million dollars worth of time was _donated_ 
willingly, just to help out the project. I _love_ these 
guys!! | 



Naturally, that officially killed the upgrade... and the 
first Catch-22 situation arose: Tandy would _consider_ 
selling it through EOS, _Lf_ it was first submitted to 
them completely done, doc'd, and packaged ready-to-sell. 

But no one had the money to do that. See, cancelled 
project = no payment :( And to do all that, without 
knowing for sure if it would be accepted? No way. 

Plus, at exactly that moment, the aew 68S machines were 
being bora, which meant all our efforts had to turn in 
that future direction instead. Not long after, the CoCo 
EOS program was stopped, So the aew upgrade got shelved. 
Veil, not totally... bits and pieces have been posted the 
whole time since, and I think we all expect that sooner 
or later, it'll fully come out. 

OTHER COMMENTS 

Ve hoaed that sucker to a fare-thee-well! Absolutely the 

sweetest OS-9 versioa arouad... smooth, fast, 99.9991 

bugfree, crunched down code. Honestly, OSK sometimes 

feels clunky in comparison... I think others agree. 
(Note: we'd change some things nowadays, because the I28K 
limit is gone) 

Again, you already have more stuff posted than the 
origiaal spec called for. Aaything after that has been 
gravy. Free gravy, too :-) 



Another good point, btw: who better to do an update, than 
the people who have to write programs aad drivers for 
aad/or use that system daily for persoaal use? 

I must also note the unbelievable secrecy, which was held 
for well over a year (until Tandy said it was okay to 
talk) by everyone. Sure, all involved signed 
nondisclosure agreements, but still it was uaprecedeated. 
I dida't evea see secrets held that well when I did NSA- 
related work. 

Another thing that was proved beyond a shadow of a doubt: 
telecommuting is viable! You couldn't find a more 
scattered group of people oa this coatiaeat, yet the 
project progressed smoothly aad ia coordiaatioa (in some 
part due to the CIS forum space and lots of phone calls 
;-). The most astoaishiag thiag was that evea while they 
were beiag iadepeadently innovative, not one person ever 
balked at my telling them that a certain method was 
unsuitable... instead they just used such rules as a 
baseline to do even more superlative work. 

So whether the 'full" upgrade comes out or not, all the 
volunteers deserve the utmost praise and high marks for 
their work. 



Anyway, now you know. 
:-) regards - kevin. 



Imost of) the rest of the story 



ooooooooooOOOOOOOOOOoooooooooo 



FIRST IMPRESSIONS OF TEE MM/ I 



A few people reading this will know that I ordered an 
MM/I way back on the 26th of March, I99I. I ordered the 
complete MM/I Extended Kit. At the time it was selling 
for USS875, which I paid, it is now US$975. 

The MM/I Extended is the MM/I mother board and the 
accompanying daughter board or I/O board. Complete with 
software and manuals and a disk drive. 



I rang Paul tfard of IMS in Washington a couple of times 
after that, just checking what was (or wasn't!) 
happening. Finally on the 2Dth of December last year I 
got a lettergram from DHL in Sydney!! Tep, it was here! 
It only took another week and a half to get it to 
Melbourne, out of bond, and into my hands. It seems the 
Compass crash also had a little to do with this delay! 
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I ifas charged 5260 import duty and the original US$975 
($875 + $100 shipping) became $1275 Australian. Fo^r a 
little over $1500 I think I've got a bargain! 



Some background! The MM/1 is an OS/9 68000 based 
computer. This i,s often called OS9-68K (K=1000) or OSK. 
OSK is the big brother of OS/9, made for the bigger, more 
ffiodern 68000 family of processors. OS/9 for the 6809 is 
no longer sold or supported by Microware. 

The MM/1 uses a Signetics 68070 processor. This thing 
runs at a little under 16MHz. It is designed for 
lultimedia applications, for example CD-TV. It has built 
into it such things as serial ports, timers and data 
channels. The other main chip in the MM/1 is the VSC or 
Video and System Controller. This chip does all the 
graphics and memory management. Sort of like a cross 
between the CoCo's GIME chip and the Amigas blitter! 



(See 
Ed) 



attached article about the 88070 and VSC chips 



The main board contains 1 Meg of memory, has two serial 
ports and all the necessary stuff like video and keyboard 
plugs. The I/O board (which Tm still waiting for) has 
the SCSI hard drive controller, sockets for more memory, 
stereo sound input and outputs, 3 more serial ports and 2 
parallel ports. 

I've mounted the main board in a mini tower case (normal 
IBM type), I'm using a normal XT type keyboard, and until 
recently a CM8 monitor. I also hard wired the megahertz 
lights on the case to "68".. just to upset IBM types! 

I've also got my two 1.44 meg 3.5" drives, plus a 1.2 meg 
5,25' drive in there as well. 

The MM/1 main board is 4»x8M Thats smaller than a 
floppy drive! 

I haven't recieved my I/O board yet, or my microware OSK 
manuals, but I did get the IMS manuals and 6 high density 
disks full of software. 

The disks contained all the 0S9 stuff needed like 
commands, and modules directories. Also an assembler, 
basic (called microware basic- its the same as basic09) 
and a C compiler. Heaps of graphics and sound demos, 
some communications programs and lots of sample programs. 

I've also filled heaps of disks with PD software I've 
gotten through the Internet. A friend from Holland sent 
me 12 disks of demos and programs and I'm grabbing GIF 
pictures pretty quick too. 

The MM/1 comes with a program to display autodesk 
animator (.fli) files. These are 256 colour fully 
animated files. Some are extremely good! I have one of 



a piece of patio furniture flying onto the screen, 
unfolding, then flying around the grand canyon! The 
speed of the MM/1 really shows with things like this. 

Also there is a kind of famous mouse deio of a mouse 
getting a fright and running off the screen. This one is 
so fast it really needs to be seen! 

The MM/1 does not have text screens. It uses graphics 
screens and draws the letters using whatever font you 
like. This is very similar to the CoCo's graphics 
windows, but due to a part of the VSC chip, called a 
Pixel Accelerator (PIXAC), this is done mostly without 
the help of the main processor. The text scrolls past 
faster than the CoCo's 80 column text screens. 

Fonts can be taken from CoCo 0S9 Level II and used on the 
MM/1 by just changing one byte. 

At the moment, the MM/Ts windows look much like the 
CoCo's. You can flip through them, create overlays and 
all the normal stuff. Eventually it is meant to have 
moveable, resizeable windows. That will be nice to see. 
(This stuff is supposed to be on the IMS update disks., 
still waiting for them too!) 

Apart from looking good in the tower case, I've found 
that with no hard drive, at least two drives is a really 
good idea. With IMeg of RAM, I get about 750k free after 
booting. Thats not enough to use a raidisk and run the 
big animation files, but its plenty to stick C source in 
the ram disk and use only one floppy. 

The C compiler is outwardly quite similar to the CoCo's. 
Except that it uses sticky modules. Sticky modules are 
modules which stay in memory until that memory is 
actually needed. Any executable program can be a sticky 
module. Vhen the MM/1 is really moving, it has all the C 
compiler modules in memory already, and compiles small 
programs in about one second! 



All of OSK is much more 
example, even the dir 
options! 



detailed than CoCo 
command has almost 



0S9. For 
a page of 



So far I've only needed to make one new boot disk! 
(Something most people hate doing with the CoCo). This 
was made so I can use my third disk drive and also to 
install a newer 
windowing stuff 



'windio* module, (windio does all the 
. this module is being updated by IMS). 



The disks contained documentation to almost everything on 
them. IMS sent me three real manuals. A hardware one 
which explains how to put it all together. A software 
one which explains simple commands and how to use the 
application programs they sent me. And a manual for 
Oddjob which is a simple language also included with the 
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MM/1, Buch like aifk for unix. 

The official Microvare manuals are still on their »ay to 
me. They contain all the conmiands and technical info. 
Also the Basic and C manuals are in there. 

When I set up fy KM/1, I loved all the plugs onto the 

back of my toirer case. The video and /tO ports both use 

DB9 connectors, so I needed two of these, and the 

keyboard plug uses the normal five pin din. IMS provides 
a disk drive cable. 

Pover is supplied to the main board from the two standard 
IBM power supply cables, ifhich plug into the mini-back 



plane. The main board is then plugged into that. 

Some more info. .. 

MM/I's should be available in Australia soon, froa a 
company called Multi-Media Australia. This is run by a 
guy called Jerome Slappy. I havn't contacted him yet. 
This info is from Paul Vard. 

IMS has a BBS set up in the United States to give users 
upgrades of their software faster. I still havn't gotten 
around to ringing this. Td rather put it off! 

Hope this information helps - Andrew Donaldson. 



ooooooooooOOOOOOOOOOoooooooooo 



MM/1 Main Board 



Palette Controller 



vsc 



68070 



Video 



/to 



Keyboar 



Eproms 




Memory Chips 
(1 Mb total) 



Roppy 
Connector 



Mini-Bus 

connector 



oppy 
Controller 



68070/VSC Specifications and Features 



I hope I'la not rocking any boats, but alot of people are 
curious about 68070/VSC specs, and nobody 'in the know" 
has revealed much. So I'm gonna blow the doors off the 
SIG and reveal all. Note: while I think every fact in 
this file is correct, I wouldn't bet $1000 on it! 

I place this file totally in the public domain... copy 
away! 



Matthew Thompson 
Ottawa, Ontario, Canada 



The SCC68070 festures: 



- Made by Signetics (Philips), uses CMOS tecnology (low 
^5mA current drain). 
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- 99.9999% MC68000 software compatability. 
Exceptions: 

- InpLeneiits full bus recovery (like the MC68010I, adding 
a measure of crash-proofing to the system. However it 
only stacks 17 words during recovery, instead of the 
68010's 29 (which the 070 manual claims is redundant, 
anyways). - In the System State the 68070 stacks four 

68000's three. - 



words (like the 68010), instead of the 
Other than that, they are identical. 



- Runs at 15 MHz, about twice as fast as standard 
based Amigas, Macs, and Ataris. 



protection; stack overflow protection; and also controls 
read/write/execute/supervisor access to any segment of 
memory. OS/K wisely does not use the HMU, however, since 
like most MMUs on high-speed CPUs it throws in an extra 
wait-state, slowing the CPU by as much as 20 percent. 

- Three 16-bit timers on-chip. All have a programmable 
increment time down to a minimum of 6.51uS. One is a 
free-running counter with auto-reload. Two are capture 
counters, which are controlled by seperate I/O pins on 
the chip. They can generate pulses, or count the time 
between input transistions, or even count the number of 
input transistions. All timers can generate an interrupt 
to the CPU. 



- Cycle times for 68070 instructions are different than 
on a 68000, though. Most instuctions take more. But at 
15 MHz, they're all faster than any of the above 68000 
systems (heh heh). A Bus Cycle is 4 Clock Cycles, while 
a Machine Cycle is 3 Clock Cycles. Most of the handiest 
instructions have been cranked somewhat faster, such as 
HOVE. 

- Two high speed DMA channels, each capable of 2.5 Mega- 
xfer/sec I/O from/to RAM xfers (one channel at a time, of 
course). Channel 1 has a higher priority than channel 2, 
and channel 2 can also do 1.25 Mega-xfer/sec RAM to RAM 
block copies. Xfers can either be in bytes or words. 
Supports daisy chaining to external DMA chips for more 
channels. The DMA ports on the 68070 are identical in 
register structure and function as the Motorola 
MC68430/40/50 DMA chips. All arbitration is handled by 
the 68070. *:Equivalent to copying thirty-nine 320 x 200 
X 256-color screens per sec! 

- r2C bus interface (r2C is an industry standard - 
lOOkbaud serial interface intended for el-cheapo chip 
interfaces. Instead of complex decoding chips and 
parallel bus wiring, any r2C device (such as 
configuration EPROMS, time clock ICs, serial port chips, 
joystick control chips, etc., etc.) can all be hooked 
together by a couple common wires, and then everything is 
handled & figured out by on-chip arbitration circuitry. 
Major reductions in wiring and design complexity are 
achieved.). 

- On-chip serial interface. Features seperate baud rates 
for receive and xiit; can generate interrupt at any 
priority level; Odd/Even/No parity; 7/8 bits; built in 
CTS and RTS lines; full/half duplex operation; framing 
error detection; and more. Using an external clock of 
4.9152MHz, you can get baud rates of 75, 150, 300, 1200, 
2400, 4800, 9600 and 19200. Using a clock of 8MHz you 
can also get 31,250 baud (MIDI speed).- 

- Also has built in MMU, with 8 descriptors on-chip, up 
to 128 with external bipolar RAM. Supports intermodule 



- Built-in prefetch cache speeds things up a bit. 

- All this on just one 84-pin, square, surface-mount 
flat-pack chip. 

- Clearly designed with one single purpose in mind; to 
cram as much power on one chip at the lowest cost. Hence 
its use in our low-cost, but high performance, MM/I and 
TC070 computers. 

The VSC chip features: 

- Real part number (hidden until now from Delphi members) 
is the SCC66470, (not 68470) and is a 124-pin flat-pack 
CMOS chip from Signetics (Philips). 

- Runs at up to 30MHz. 

- Max 768 by 560 resolution. 

- Max 256 colors at 384 by 560, 16 at 768 by 560, 256 at 
768 by 560 if a second 66470 is connected in lore-or-less 
parallel. I am not sure if such a piggybacking scheme 
will be officially supported for the MM/I or TC070 (this 
is not the same as the palette board being offered). 



- Supports 31.5 kHz 
crank it. 



horizontal scan if your monitor can 



- Has on-chip DRAM and SRAM controller which supports 
bit, nybble, page and dual port RAMs. 



- Max I Keg video 
SRAM supported. 



RAM, extra 0.5 Meg DRAM and 0,5 Meg 



- Built in Blitter (PIXAC - PIXel Accelerator). 

- Has all kinds of blitting features that make block and 
pixel blitting fast and easy. Each blitting operation 
affects a word value (ie up to 2 or 4 pixels depending on 
mode) at a time, and each word 'takes less than 500nS to 
process." For instance, the 66470 can take a one-pixel- 
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per-bit image defiiiLtioa (such as a font), convert those 
bits into nybbles or bytes of the correct fQreground,^jnd 
blit the result on the screen while nasking the 
background using a transparent color, so that only those 
bits that were set affect the screen. On top off all 
this a programiiaMe logic operation between the source 
and destination pixels can be thrown in for good measure. 
A 64 X 64 screen blit on a l6-color screen would only 
take (a guesstimated] 5I2uS or less. About the only way 
to blit faster is if all you want to do is a plain 
vanilla copy, thus the DMA could copy a 64 x 64 16-color 
block in about 45 uS. Anything else would require a 
fancy CPU algorithm that would take mega time. And while 
the VSC is blitting, the CPU can do other things. The 
VSC blitter can also allign source nybbles to destination 
nybbles, so that any pixel boundary can be used. 

- Block blit functions include COPY (raw), PATCH (raw 
with xparent masking), EXCHASGE (switch two image areas), 
SVAP (switch with xparent masking), COLORl (take all non- 
xparent source pixels and turn destination into 
foreground color), C0L0R2 (like COLORl except xparent 
pixels -) background), BCOLORl (like COLORl, except 
performs bit-to-nybble or bit-to-byte expansion), BC0L0R2 
(combo of C0L0R2 and BCOLORl), COMPARE (compare pixels, 
set flag if match), and COMPACT (compare pixels, create a 
table of flags). 

- The reccommended color sceme is RGBI for 16-color 
screens, and RRRGGGBB for 256-color screens (blue is less 
noticeable hence it is allotted two bits of resulution). 

- Also supports smooth scrolls and virtual windowing. 

- Can also shrink or zoom by a factor of two 
independently in the horizontal and vertical directions 
during all blits. Instant multisize fonts! 

- The Amiga's blitter is a "monochrome" blitter. To 
affect a mutlicokr screen it has to blit each Amiga bit 
plane separately. The VSC uses a nybble/byte scheme and 
does all color computation in one access. The Amiga's 
blitter is also so complicated to program that the 
current release of the operating system uses the CPU to 
blit text, because it takes so long to set up the blitter 
that it would actually take longer. The VSC was made for 
blitting text, and for all kinds of block copies and 
exchanges. The Amiga's blitter may still be faster at 
one-pixel-wide operations, like random-angle diagonal 
lines, or curved lines. I won't know till I see the 
bottom lines for the two machines. 

- Pixel and block testing, making collision detection in 
games and etc. incredibly fast. 



- On average 3 to 8 times as fast as a 
more. 

- Can cut algorithm sizes by up to 98t. 



alone, even 



- Genlock and frame grabbing support with some extra 
logic and a PLL, and for frame grabbing, a flash-ADC 
convertor. Real-time, 60 frame-per-second image 
digitization is easily possible. 

- Based on the specs for this baby, we ought to see some 
impressive graphics games, like Microsoft Flightsim V4.0 
out running on a 320 by 200 by 16-color screen at a frame 
rate of, oh, say... 10 per second!? 



eliminating more 



- Also has built in reset ciruitry, 
discrete parts. 

- Support for watchdog timer. 



- Designed with one purpose in mind: to crank the 
graphics speed to the max at the lowest cost. And since 
it is designed to work hand-in-hand with the 68070, it's 
the obvious choice for a gfx chip for the TC070 and MM/1. 

Note that the MM/1 and TC070 only go to 480 vertical 
resolution max because to get 560 you have to use a 625- 
line 50Hz-scan standard like PAL (but the flicker would 
be bad). HTSC is 525 lines at 60Hz. The max horizontal 
is 720 for similar reasons. 

Also, note that normally the 66470 arbitrates between 
itself and the 68070 as to whose turn it is to look at 
RAM. It does this in the single-board version of the 
MM/1. But both the full MM/1 and TC070, which support 
over 2 Meg (way beyond the 66470 DRAM controller), 
obviously have seperate DRAM controllers and semi- 
seperate buses. The VSC gets a Meg to itself, the CPU, 
gets the rest to itself, and they both crank along at 
maximum, zero-wait-state speed. The 68070 doesn't have 
to wait for the VSC to grab a video word, and the VSC no 
longer has to wait for the CPU to be finished to get or 
put a blitting word. So they BOTH speed up (despite some 
kidding on the forum!), The 68070 can still access the 
video RAM, of course, but it might have to wait (a VSC 
bus access is 4 clock cycles, the same as the CPU). 

Put it this way: Vith these two chips at the heart of the 
MM/1 and rC070, it will quite some time before the 
competition gets as much speed and features for as low a 
cost as either system! -- 

Brian lifhite (Using a friends account) 



ooooooooooOOOOOOOOOOoooooooooo 
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k C Tutorial 
Chapter 6 - Defines and HacroB 



DEFISES AHD MACROS ARE AIDS TO CLEAR PROGRAHHIHG 

Load and display the file naied DEFIHE.C for your 
first look at sone defines and iiacros. fiotice the first 
four lines of the progran each starting with the word 
'fdefineV This is the way all defines and aacros are 
defined. Before the actual coapilation starts, the 
conpiler goes through a preprocessor pass to resolve all 
of the defines. In the present case, it will find every 
place in the prograii where the coiibination 'START" is 
found and it will siaply replace it with the since that 
is the definition. The compiler itself will never see 
the word 'START', so as far as the compiler is concerned, 
the zeros were always there. 

It should be clear to you by now that putting the 
word 'START' in your program instead of the numeral is 
only a convenience to you and actually acts like a 
comment since the word 'START' helps you to understand 
what the zero is used for. In the case of a very small 
program, such as that before you, it doesn't really 
matter what you use. If, however, you had a 2000 line 
program before you with 27 references to the START, it 
would be a completely different matter. If you wanted to 
change all of the STARTs in the program to a new number, 
it would be simple to change the one l^define, but 
difficult to find and change all of the references to it 
manually, and possibly disastrous if you missed one or 
two of the references. 

In the same manner, the preprocessor will find all 
occurrences of the word "EHDING' and change them to 9, 
then the compiler will operate on the changed file with 
no knowledge that 'ENDIHG' ever existed. It is a fairly 
common practice in C programming to use all capital 
letters for a symbolic constant such as 'START' and 
'ENDISG' and use all lower case letters for variable 
names. You can use any method you choose since it is 
mostly a matter of personal taste. 

IS THIS REALLY USEFUL? 

tfhen we get to the chapters discussing input and 
output, we will need an indicator to tell us when we 
reach the end-of-file of an input file. Since different 
compilers use different numerical values for this, 
although most use either a zero or a minus I, we will 
write the program with a 'define' to define the EOF used 
by our particular compiler. If at some later date, we 
change to a new compiler, it is a simple matter to change 
this one 'define' to fix the entire program. End-of-line 
is another indicator that is not universal. This will 
make more sense when we get to the chapters on input and 
output. 

VHAT IS A MACRO? 



A macro is nothing more than another define, but 
since it is capable of at least appearing to perform some 
logical decisions or some math functions, it has a unique 
name. Consider the third line of the program on your 
screen for an example of a macro. In this case, anytime 
the preprocessor finds the word 'MAX' followed by a group 
in parentheses, it expects to find two terms in the 
parentheses and will do a replacement of the terms into 
the second definition. Thus the first term will replace 
every 'A' in the second definition and the second term 
will replace every 'B' in the second definition. 

Vhen line 12 of the program is reached, 'index' will 
be substituted for every 'A', and 'count' will be 
substituted for every 'B', Remembering the cryptic 
construct we studied a couple of chapters ago will reveal 
that 'mx' will receive the maximum value of 'index' or 
'count'. In like manner, the 'Mil' macro will result in 
'mn' receiving the minimum value of 'index' or 'count'. 
The results are then printed out. There are a lot of 
seemingly extra parentheses in the macro definition but 
they are not extra, they are essential, ife will discuss 
the extra parentheses in our next program. 

Compile and run DEFISE.C, 

LETS LOOK AT A WROHG MACRO 

Load the file named MACRO. C and display it on your 
screen for a better look at a macro and its use. The 
first line defines a macro named 'VRONG' that appears to 
get the cube of 'A', and indeed it does in some cases, 
but it fails miserably in others. The second macro named 
'CUBE' actually does get the cube in all cases. Consider 
the program itself where the CUBE of i+offset is 
calculated. If i is 1, which it is the first time 
through, then we will be looking for the cube of 1+5 = 6, 
which will result in 216. Vhen using 'CUBE', we group 
the values like this, (l+5)Ml+5)MI+5) = 6*6H = 216. 

However, when we use VROHG, we group them as 
1+5*1+5*1+5 = 1+5+5+5 = 16 which is a wrong answer, The 
parentheses are therefore required to properly group the 
variables together. It should be clear to you that 
either 'CUBE' or 'VRONG' would arrive at a correct answer 
for a single term replacement such as we did in the last 
program. The correct values of the cube and the square 
of the numbers are printed out as well as the wrong 
values for your inspection. The remainder of the program 
is simple and will be left to your inspection and 
understanding. 

PROGRAMMING EXERCISE I. 

^ Write a program to count from 7 to -5 by counting 
down. Use l^define statements to define the limits. 
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(Hint, you vill need to use a decrenenting variable in the third part of the 'for' loop control) 

ooooooooooOOOOOOOOOOoooooooooo 



An Index of Rainbow 0S9 Articles 

conpiled by Bob Devries 

January - Decenber '88 



January 1988 page 156 

Stalking the Fire-Breathing Dragon - Tips for the 0S9 

beginner. 

Sancy Ewart 

January 1988 page 166 

Catch the tfave - Help for 0S9 users. 

Cray Augsburg 

January 1988 page 160 

nSSable 0S9 - Back at the drawing board, 

Dale L. Puckett 

January 1988 page 176 

0S9 PrograiiEing - Screen dunping revisited. 

Peter Dibble 

February 1988 page 152 

The Iiipact of Hulti-Vue - A first look at Tandy's user- 
friendly interface for 0S9 Level II. 
Cray Augsburg 

February 1988 page 182 

SISSable 0S9 - Using a fourth-generation database 

language. 

Dale L. Puckett 

March 1988 page 180 

nSSable 0S9 - A view of Kulti-Vue. 

Dale L. Puckett 

April 1988 page 160 

nSSable 0S9 - New tools, new toys. 

Dale L. Puckett 

May 1988 page 178 

nSSable 0S9 - Patches, prograiis and politics. 

Dale L. Puckett 



June 1988 page 14 

Help is on the way - Create online assistance. 

Stephen B. Goldberg 

June 1988 page 180 

KlSSable 0S9 - Another great beginning. 

Dale L. Puckett 

July 1988 page 16 

A new outlook for 0S9 - Using subdirectories and shell 

scripts to build an 0S9 iienu systei. 

Kark Eosenan 

July 1988 page 174 

SISSable 0S9 - Sending the right signals. 

Dale L. Puckett 

August 1988 page 182 

KISSable 0S9 - Volunteers build a better nousetrap. 

Dale L. Puckett 

October 1988 page 147 

KISSable 0S9 - Another cry for standards. 

Dale L. Puckett 

Noveiiber 1988 page 176 

nSSable 0S9 - Installation, autoiation and lore. 

Dale L. Puckett 

Decenber 1988 page 160 

Paraneter Changes Hade Easy - Take the drudgery out of 

changing paraneters. 

Steve Goldberg 

December 1988 page 178 

KISSable 0S9 - Better tools are here, 

Dale L. Puckett 



ooooooooooOOOOOOOOOOoooooooooo 

CoCo-Link 
CoCo-Link is an excellent nagazine to help you with the RSDOS side of the Colour Conputer. It is a bi-Bonthly magazine 
published by Mr, Robbie Dalzell. Send your subscriptions to: 

CoCo-Link 

31 Hedlands Crescent 

Pt. fioarlunga Sth. 

South Au8tc*lia 

Phone: (08) 3861647 
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